home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / src / exampleCode / opengl / GLR / glrduck / README < prev    next >
Text File  |  1996-11-11  |  3KB  |  69 lines
  1. ------------------------------------------------------------------------------
  2.  
  3. UNFORTUNATELY, The IRIX 6.2 GLR library is not available at this time. 
  4.  
  5.      We hope to have inst images available with the v6.2 DT releasing at the
  6.      end of this calendar year. Please stay tuned to the location: 
  7.        https://www.sgi.com/toolbox/src/exampleCode/opengl/GLR/ 
  8.      Once we have the software onboard, we'll indicate its presence and 
  9.      location on this page.
  10.  
  11. ------------------------------------------------------------------------------
  12.  
  13. GLR - an OpenGL Render Server Facility. Please see the GLR README for more
  14.       information on GLR.
  15.  
  16. Glrduck - is a rehash of the GLR example program glrduckpond.c++ using 
  17.           ViewKit and Open Inventor. The main difference being glrduck 
  18.           creates a sub-class of the SoXtRenderArea called SoXtGLRRenderArea.
  19.  
  20. REQUIRED LIBS:
  21.  
  22. 1. OpenInventor 2.1 or 2.1.1
  23. 2. ViewKit
  24. 3. OpenGL
  25.  
  26.  
  27. FILES:
  28.  
  29. Makefile:        SGI compliant makefile.
  30. main.C:            main.
  31. SoXtGLRRenderArea.C:    SoXtRenderArea derived class source file.
  32. SoXtGLRRenderArea.h:    SoXtRenderArea derived class header file.
  33. glrduck.C:        VkApp derived class source file.
  34. glrduck.h:        VkApp derived class header file.
  35. Glrduck:        Xt resource file.
  36. duck.iv:        Inventor graphics file of duck.
  37.  
  38. HOW IT WORKS:
  39.  
  40. The SoXtGLRRenderArea class provides the connection to GLR. It handles the
  41. GLR initialization and drawing. The initialization of GLR is done in the
  42. class constructor. If a connection cannot be made then glrduck prints an
  43. error message a uses local rendering hardware. The public drawing method
  44. takes a flag to determine whether rendering should be local or GLR remote.
  45.  
  46. THINGS TO WATCH FOR:
  47.  
  48. This version glrduck tries to acquire an RGB canvas type. If this is changed
  49. to something other than RGB then the image pointer array size must be changed.
  50. (e.g. RGBA then new GLubyte[size[0] * size[1] * 4]; )
  51.  
  52. Before rendering to the remote hardware private render method "renderRemote()"
  53. invalidates the Inventor cache. See: (getGLRenderAction()->invalidateState();)
  54.  
  55.  
  56.  
  57. WHAT PLATFORMS AND OPERATING SYSTEMS ARE SUPPORTED?
  58.  
  59. You may use GLR with any SGI workstation running IRIX 5.3 or higher. While the
  60. render server can run on any SGI workstation, including low-end machines, it's
  61. preferable that it be run on a high-end machine (e.g. RealityEngine).
  62.  
  63. I have tested glrduck on an Indigo 2 running both IRIX 5.3 and Beta IRIX6.2,
  64. using a RealityEngine running IRIX 5.3 as the GLR server.
  65.  
  66.  
  67. IMPORTANT: When the glrmanager is running on a machine, the display is unusable
  68. for anything else.
  69.